home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / doom / fmecad64.zip / FMECAD64.TXT < prev   
Text File  |  1995-09-01  |  11KB  |  257 lines
  1. ********************************************************************
  2.                      FMECAD by Carlos Gomez
  3. ********************************************************************
  4.  
  5. OVERVIEW
  6.  
  7.   FMECAD is an object editing program for Dark Forces.  Objects in 
  8.   the FME (frame) format would include keys, batteries, energy, 
  9.   medkits, and other things that you can pick up during the game.  
  10.   FMEs are also used as scenery.  Such as chains, cups from Jabba's 
  11.   ship, the infamous ashtray, and several lights.  You can recognize 
  12.   an FME instantly, because it will always look the same no matter 
  13.   where you view it from.  There are two types of  FMEs.  Compressed 
  14.   and Uncompressed.  So if you are knowledgeable with DFuse you can 
  15.   extract an FME from the SPRITES.GOB and move it to the directory 
  16.   where FMECAD lives.  If you don't have DFuse you will have to download an 
  17.   ungobbing utility.  You don't need to do this though.  You can 
  18.   start an FME from scratch!  
  19.  
  20.   FMECAD will also allow you to animate up to 32 frames. It will also allow 
  21.   you to save your animations in .PAC format, which is explained in 
  22.   more detail below. 
  23.  
  24. CREDITS     I would like to thank all of the AOL DFers for all 
  25.             of their help.
  26.  
  27.                              
  28.       Special Kudos to Keemo and Krud. 
  29.       Krud actually has his own lawyer. Can you say "Retainer".
  30.       Keemo is actually crazy enough to run tech on FMECAD. Perhaps 
  31.       Gerrr-ronn-nehh-moee, would be a better name. Keemo also penned most
  32.       of this text. Thanks Dude-lys
  33.        
  34.  
  35.              
  36.  
  37. SYSTEM REQUIREMENTS
  38.   If you are playing DF, then you have plenty of horsepower. Or..386x25 w 1meg
  39.   XMS and SVGA compatible w/512k vid mem will fire it up. Oh yeah, better have a mouse.
  40.   Can't even quit without it. Besides, who draws with the keyboard. Uh..
  41.   anymore.
  42.  
  43.  
  44. LIST OF FUNCTIONS
  45.  
  46. All commands are activated by using the left mouse button unless 
  47. otherwise specified.  Colors can be changed by using the left mouse 
  48. button on the palette in the lower right corner of the screen.
  49.  
  50.                             DRAWING AREA
  51.    Left mouse but = Color Block with current color
  52.    Right mbut     = Color Block with color zero > Erase
  53.                             
  54.                             MENU ITEMS
  55.    New = starts a new file
  56.    Load = load an existing file 
  57.    Save = save file
  58.    Filename = Can use up to 17 characters to describe a pack of 32 frames
  59.               Activation - left mouse button
  60.               Deactivate - enter or escape
  61.  
  62.    File Num  = Will scroll for saved packs of 32 frames
  63.              Activation - left and right mouse button
  64.  
  65.    Eras = Erase currently selected frame with confirmation prompt
  66.  
  67.    FClr = Find Color - "What color is that" left mbut to activate/ put cursor 
  68.           on block you want to identify in the Drawing Area- left mbut again 
  69.           sets current color to color in Block 
  70.    
  71.    Grid = Toggle grid on and off
  72.  
  73.    Prev = View selected frame in 320x200 mode ( closest to DF )
  74.  
  75.    AnPr = Animate Preview in 320x200 mode
  76.              Uses Animate selected numbers to run
  77.  
  78.    PAL = Load a different palette from the FMECAD directory. Must be 768 byte
  79.          file with .PAL extention.
  80.  
  81.    Quit = No save with confirmation prompt - must manually save stuff before 
  82.           quitting. I'm sweating already.
  83.  
  84.    Frame = Frame Advance  
  85.               Activation - left and right mouse buttons
  86.  
  87.    Insert = Insert Advance - Choose where to stamp copy of currently 
  88.             selected frame
  89.               Activation - left and right mouse buttons
  90.  
  91.    Insert Frame  = Insert a frame with confirmation prompt
  92.    
  93.    Animate  = Action button for animation
  94.  
  95.        1      to     32
  96.     AniLwr          AniUpr
  97.  
  98.    AniLwr   = Animate Lower Bound / which frame to start with for 
  99.               animation
  100.             Activation - left and right mouse buttons
  101.  
  102.    AniUpr   = Animate Upper Bound / which frame to end with for animation
  103.             If AniUpr is a smaller number then AniLwr, the animation 
  104.             will happen in reverse.
  105.             Activation - left and right mouse buttons
  106.  
  107.    Delay = How long to delay in between frames. The animation is 
  108.             pretty fast and you probably will not see anything happen 
  109.             if the delay is on 0.
  110.             Activation - left and right mouse buttons
  111.  
  112.    Loop     = how many times to view animation
  113.              Activation - left and right mouse buttons
  114.  
  115.    Extract to .FME = Will save your file as an .FME.  With confirmation 
  116.                     and file name prompt.
  117.    
  118.    Load FME to Frame = Provide the name of the fme, must be in FMECAD dir,
  119.                        to be loaded to the current frame. Will erase current
  120.                        frame before loading.
  121.    
  122.    FLIP = Flips ( mirrors ) current frame
  123.           LSM =  upper left to lower right mirror line
  124.           RSM =  upper right to lower left mirror line
  125.           UDM = up/down mirror line
  126.           RLM = right/left mirror line
  127.           CCW =  rotates frame 90 degrees counter clock wise
  128.           CW = rotates frame 90 degrees clock wise
  129.           D = mirrors frame diagonally
  130.  
  131.                  ''''''''''''''Special Note'''''''''''''''' 
  132.      I wrote this puppy with convience in mind. With that in mind, I tryed to
  133.   make FMECAD as intuitive as possible. Still, we all have pressed the wrong
  134.   button at some point and saw hard work disappear. At first, I wrote it so
  135.   that the frame advance button would be the only button that would "SAVE"
  136.   the frame to memory. Not very friendly indeed. 
  137.      A complier book fell on my head and in my unconciousness, I dreamed of the
  138.   perfect program. One that would operate flawlessly and take out the trash.
  139.   One that could perform what was in my minds eye and one that would mow the
  140.   yard. Obviously, there was some damage, but the point is that I kept those
  141.   ideas as platforms and have plenty of confirmation prompts. Just in case.
  142.         
  143.  
  144.  
  145.                          FMECAD PAC Format  
  146.  
  147.      Files will be saved as 1.pac, 2.pac etc.. up to 100.pac that 
  148.   gives you up to 3200 frames to save. The PAC format needs to be understood 
  149.   to those who would like to make conversion programs. FMECAD will gladly 
  150.   accommodate up to 99x by 99y by 32 frames. 
  151.  
  152.   Here is my header:
  153.       TYPE header1
  154.          PACNAME AS STRING * 17 = Name of PAC file
  155.          TOTPAC AS INTEGER      = How many PACs in directory
  156.          PAL AS STRING * 768    = Palette stored in PAC
  157.          TOTFRAMES AS INTEGER   = Total frames stored in PAC
  158.       END TYPE
  159.       TYPE header2
  160.          COMPLFT AS INTEGER     - The COMPress names are used at save time
  161.          COMPRHT AS INTEGER     - to mark the correct location in the Drawing
  162.          COMPTOP AS INTEGER     - Area. Essentially, the x1,x2,y1,y2 coordinates
  163.          COMPBOT AS INTEGER     - in a 99 by 99 grid. 0x,0y is LFT-TOP
  164.          FRAMEFILELEN AS LONG   = The byte length of the frame
  165.          FRAMETAKEN AS INTEGER  = Will be 1 through 32
  166.       END TYPE
  167.       DIM HEAD1 AS header1
  168.       DIM HEAD2(1 TO 32) AS header2
  169.  
  170.       A final note on the COMPress vars: FMECAD only saves a square of what
  171.       was actually drawn and not the whole 99 by 99 grid. The COMPress
  172.       function finds the x1,x2,y1,y2 coordinates and only saves that amount.
  173.       Frame files can be large 627,746 bytes alone for 32  99 by 99 frames.
  174.       So watch your drive space!                     
  175.                            
  176.                               PAC byte by byte
  177.  
  178.   PACNAME   = Bytes 1 through 17
  179.   TOTFRAMES = Bytes 18 and 19. This number gives you the "how many times" to
  180.                                read in your load loop.
  181.          
  182.                   Now the PAC can be read in a LOOP
  183.   FRAMENUM     =  2 BYTES
  184.   COMPTOP      =  2 BYTES
  185.   COMPBOT      =  2 BYTES
  186.   COMPLFT      =  2 BYTES
  187.   COMPRHT      =  2 BYTES
  188.   FRAMEFILELEN =  4 BYTES
  189.                 
  190.         Once those are read, an array of integers can be dimensioned to
  191.   FRAMEFILELEN